home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Internet / WWW / Perl_WWW_Utilities / MHonArc / RELNOTES < prev   
Encoding:
Text File  |  1996-04-18  |  5.8 KB  |  162 lines
  1. Release Notes for MHonArc
  2.  
  3.     <URL:http://www.oac.uci.edu/indiv/ehood/mhonarc.html>
  4.  
  5. ---------------------------------------------------------------------------
  6.     MHonArc -- Internet mail-to-HTML converter
  7.     Copyright (C) 1995,1996  Earl Hood, ehood@convex.com
  8.  
  9.     This program is free software; you can redistribute it and/or modify
  10.     it under the terms of the GNU General Public License as published by
  11.     the Free Software Foundation; either version 2 of the License, or
  12.     (at your option) any later version.
  13.  
  14.     This program is distributed in the hope that it will be useful,
  15.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  16.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17.     GNU General Public License for more details.
  18.  
  19.     You should have received a copy of the GNU General Public License
  20.     along with this program; if not, write to the Free Software
  21.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  22. ---------------------------------------------------------------------------
  23.  
  24. Version 1.2.2
  25. -------------
  26.  
  27. This version is a minor enhancement, bug fix release.  See the CHANGES
  28. files for what was added and fixed.
  29.  
  30. ---------------------------------------------------------------------------
  31.  
  32. The following are release notes from previous versions of MHonArc.
  33.  
  34. Version 1.2.1
  35. -------------
  36.  
  37. This version is a minor enhancement, bug fix release.  See the CHANGES
  38. files for what was added and fixed.
  39.  
  40.  
  41. Version 1.2.0
  42. -------------
  43.  
  44. The CHANGES file contains information on the changes that may affect
  45. 1.1.0 archives.  Please read it.
  46.  
  47.  
  48. Version 1.1.0
  49. -------------
  50.  
  51. Database file:
  52.     1.1.0 is able to handle 1.0.x database files.  Only additions
  53.     have been made between 1.0.x and 1.1.0.
  54.  
  55. Threading:
  56.  
  57.     o  If you have a 1.0 archive, you can generate a thread index
  58.        for it with the following:
  59.  
  60.         mhonarc -thread -editidx ...
  61.  
  62.        NOTE:  You will also need to (re)specify the LISTBEGIN
  63.        resource so a link to the thread index exists on the main
  64.        index page.  See the section on _Index Page Customization_
  65.        in the documentation for more information.
  66.  
  67.     o  You can prevent the creation of the thread index by the
  68.        following:
  69.        
  70.         *  Set the M2H_THREAD environment variable to 0.
  71.         *  Specify the NOTHREAD resource file element.
  72.         *  Use the -nothread option.
  73.  
  74.     o  Remember, the thread index does not replace the main index.
  75.        It compliments the main index.  If using a custom layout,
  76.        resource variables are available to link between the 2
  77.        indexes.
  78.  
  79.  
  80. The following note is only relevant if you have developed your own
  81. MIME filters for use in MHonArc:
  82.  
  83.     o  MHonArc now treats the return value from MIME filters as
  84.        an array.  The first value of the array is treated as the
  85.        HTML text to use in the message.  All other array values are
  86.        treated as names of files that the filter may have generated
  87.        (eg. mhexternal.pl).  MHonArc stores the filenames in the
  88.        database.  Therefore, MHonArc can delete any extra files
  89.        associated with a message if the message is removed via the
  90.        -rmm option.
  91.  
  92.  
  93. Version 1.0.0
  94. -------------
  95. * (See also Beta User Notes below if you were a user of 1.0.0 beta)
  96.  
  97. The release notes for version 1.0.0 of MHonArc address compatiblity
  98. issues with the mail2html 3.1.x program.
  99.  
  100.     o  The database file is compatible with mail2html database
  101.        files, however the icon support feature will not work
  102.        properly.  Recreate the archive with MHonArc if icon usage
  103.        is desired.
  104.  
  105.     o  The database filename has been renamed to ".mhonarc.db".
  106.        HOWEVER, MHonArc will use the ".mail2html.db" file when
  107.        adding to archives created with mail2html.
  108.  
  109.     o  Many of the index page resource settings have been eliminated,
  110.        like DATE and SUBONLY.  The same effects can be obtained by
  111.        using the LITEMPLATE resource element.
  112.  
  113.     o  The STAMP resource has been eliminated since the same effect
  114.        can be achieve with the LISTBEGIN or LISTEND resource elements.
  115.  
  116.     o  The USERSUBS resource element has been eliminated.  You can
  117.        achieve the same results by writing your own MIME filter, or
  118.        modifying the existing ones.
  119.  
  120.  
  121. 1.0.0 Beta User Notes
  122. ---------------------
  123.  
  124.     o  The number of library files have been reduced (beta 8).  The
  125.        library 'mhexternal.pl' is a merging of the application,
  126.        audio, image, and video libraries.  mhexternal.pl covers all
  127.        the content-types in the old filters, plus much more.  The
  128.        library is designed to be a catch-all library for
  129.        content-types that get filtered to external files.
  130.  
  131.        **IMPORTANT NOTE:  Because of the change in libraries, any
  132.        archive database files created with beta version less than 8
  133.        will cause MHonArc to abort abnormally:  i.e.  Perl aborts
  134.        because it cannot require the libraries specified in the
  135.        database file.  You can utilize the file deffilters.rc in
  136.        the examples directory, with the -rcfile option, to update
  137.        the database when adding new mail.
  138.  
  139.     o  The PERLINC resource element is recognized (beta 8).  The
  140.        docs used PERLINC, but the code used PERLLIB.  Also, the
  141.        paths specified in the PERLINC resource element are saved
  142.        to the database.
  143.  
  144.     o  The default filter libraries' filenames have been renamed to
  145.        14 characters, or less (beta 5).  This is to avoid conflicts
  146.        with older Unix file systems with filename limits.  See
  147.        **IMPORTANT NOTE above about the effects of library filename
  148.        changes.
  149.  
  150.     o  The default filters had a bug fixed in them (beta 5).
  151.        Content-Description text is now properly "htmlized".
  152.  
  153.     o  The $CURDATE$ variable went away for the LISTBEGIN or
  154.        LISTEND resource elements (beta 3).  Use $GMTDATE$ to get
  155.        the current date based off GMT time, and use $LOCALDATE$ to
  156.        get the local date and time for your timezone.  $CURDATE$
  157.        used to give only the GMT date and time.
  158.  
  159.  
  160. ---------------------------------------------------------------------------
  161. Earl Hood, ehood@convex.com
  162.